cs-payu-sapi icon

cs-payu-sapi

(0 reviews)

📘 Documentación de la API - CS PayU SAPI

Esta sección describe los atributos y uso de la cs-payu-sapi, versión v1. Esta System API interactúa directamente con la PayU REST API para realizar operaciones de tokenización, pagos, reembolsos y reportes.


💂️ Información Base

  • Título de la API: cs-payu-sapi
  • Versión: v1
  • URL Base: https://cs-payu-sapi-{env}-v1.us-e1.cloudhub.io/api/
  • Entornos: dev, qa, prod

🔑 Autenticación

Encabezados Requeridos

EncabezadoTipoDescripción
AuthorizationStringToken Bearer en el formato Bearer {{API_KEY}}
client_idStringIdentificador único para clientes API

📌 Estos encabezados son requeridos en todas las solicitudes.


✨ Endpoints Principales

📄 Tokenización de Tarjetas de Crédito

POST /credit-card/tokens
  • Descripción: Crea un token para una tarjeta de crédito.
  • Solicitud y Respuesta: Ver ejemplos en examples/requests/post-token.json y examples/responses/post-token.json.
GET /credit-card/tokens
  • Descripción: Obtiene tokens de tarjetas de crédito filtrados por rango de fechas.
  • Parámetros de Consulta:
    • startDate: datetime-only
    • endDate: datetime-only
DELETE /credit-card/tokens/bulk
  • Descripción: Elimina múltiples tokens de tarjetas de crédito vía carga de archivo.
  • Formatos de Cuerpo Soportados: application/json, text/csv, application/octet-stream
POST /credit-card/tokens/bulk/registration
  • Descripción: Registra múltiples tokens de tarjetas de crédito usando un archivo.
DELETE /credit-card/tokens/{tokenId}
  • Descripción: Elimina un token específico de tarjeta de crédito.
  • Parámetro de Consulta Requerido: payerId

💰 Pagos

GET /payments/available-methods
  • Descripción: Obtiene métodos de pago disponibles.
POST /payments/credit-card
  • Descripción: Procesa un pago con tarjeta de crédito.
POST /payments/cash-or-referenced
  • Descripción: Procesa un pago en efectivo o basado en referencia.
POST /payments/PSE
  • Descripción: Procesa un pago PSE (transferencia bancaria en línea).
POST /payments/bulk-tokens
  • Descripción: Procesa múltiples pagos usando tokens desde un archivo.

🏦 PSE (Banca en Línea)

GET /PSE/banks
  • Descripción: Obtiene la lista de bancos disponibles para pagos PSE.

📊 Reportes

GET /reports
  • Descripción: Obtiene detalles de transacciones basados en un referenceCode.

💸 Reembolsos

POST /refunds
  • Descripción: Envía una solicitud de reembolso completo.
POST /partial-refunds
  • Descripción: Envía una solicitud de reembolso parcial.

⚠️ Códigos de Error

CódigoDescripciónSolución Sugerida
400Solicitud IncorrectaVerificar parámetros de consulta.
401No AutorizadoVerificar credenciales de autenticación.
404No EncontradoNo se encontraron datos para la entrada proporcionada.
500Error Interno del ServidorReintentar o contactar soporte técnico.

📞 Soporte

Para asistencia, contacta al equipo de Coordinación de Servicios de Integración y Aplicaciones.

Correo electrónico: epalma@fgs.co


📅 Información Adicional

  • Documentación actualizada por última vez: Septiembre 2025*
  • Para actualizaciones adicionales, consulta el Portal de Exchange de API

Documentación actualizada en Septiembre 2025 por epalma@fgs.co - Edna Nayibe Palma

© 2025 Fundación Grupo Social - Colmena. Archivo generado para la API cs-utilities-system-api-services


Reviews